\documentclass[a4paper,12pt]{article}
\usepackage[left=3cm,top=2.0cm,right=3cm]{geometry}
\usepackage[pdftex]{graphicx}
\usepackage[portuges]{babel}
\usepackage[utf8]{inputenc}
\usepackage{hyperref}
\usepackage{cite}
\usepackage[bottom]{footmisc}

\title{Manual do Usuário\\IM Next}
\author{Thiago C. Fernandes}

\begin{document}

\maketitle

\begin{abstract}
  Como utilizar o IM Next
\end{abstract}


\section{Introdução}

O \emph{IM Next} consiste de duas partes básicas: O \textbf{Cliente} e o
\textbf{Bot}.

O \textbf{Cliente} é o programa que os usuários normais devem
utilizar. Já o \textbf{Bot} é a aplicação que o administrador deve
rodar.


\section{Cliente}

\subsection{Instalação}

Existem duas versões do \emph{IM Next}: Versão Moblin (oficial) e
versão Desktop. Segue a explicação de como instalar a aplicação em
ambas as plataformas mas não esqueça de baixar a versão correta.

Para instalar o \textbf{Cliente} acesse o site
\href{http://imnext.googlecode.com}{IM Next} e baixe a versão mais
atualizada do \emph{IM Next} em formato pacote debian.

Após o descarregamento do arquivo, execute:

\begin{verbatim}
dpkg -i imnext_versão_recente
\end{verbatim}

Troque \textbf{imnext\_versão\_recente} pelo arquivo descarregado.

Caso deseje utilizar a versão de desenvolvimento, que nem sempre
estará funcionando, baixe a versão do repositório SVN com o seguinte
comando:

\begin{verbatim}
svn co http://imnext.googlecode.com/svn/trunk imnext
\end{verbatim}

\subsection{Execução}

Após a instalação do \emph{IM Next} o seu ícone irá aparecer no tela
principal do Moblin\footnote{Caso tenha instalado a versão Desktop, o
  ícone encontra-se em Aplicações$\rightarrow$Internet}. O \emph{IM
  Next} pode ser executado tanto clicando no ícone quanto executando
pelo terminal\footnote{Na versão Desktop, execute-o utilizando a opção
  -d}:

\begin{verbatim}
imnext.py 
\end{verbatim}

A primeira vez que o \emph{IM Next} executar, a seguinte tela será
mostrada \ref{fig:tela_inicial} informando que você esta
desconectado. O primeiro passo então é criar um novo usuário.

\begin{figure}
  \centering
  \includegraphics[totalheight=0.2\textheight]{img/imnext_tela_inicial.png}
  \caption{Tela inicial - versão Desktop}
  \label{fig:tela_inicial}
\end{figure}

Para criar um novo usuário, clique em
\textit{Arquivo}$\rightarrow$\textit{Novo}
\ref{fig:criando_novo_usuario}. Surgirá uma nova tela requisitando o
nome do usuário, senha e o local onde você está
\ref{fig:dados_novo_usuario}. O nome do usuário deve ser o login
utilizado no servidor jabber.org\footnote{O usuário deve estar
  previamente registrado nos servidores do jabber.org} e o local onde
você está pode ser escrito de forma livre, como \textit{São Paulo, SP,
  Brasil}.

\begin{figure}
  \centering
  \includegraphics[totalheight=0.2\textheight]{img/imnext_criando_novo_usuario.png}  
  \caption{Criando novo usuário - versão Desktop}
  \label{fig:criando_novo_usuario}
\end{figure}

\begin{figure}
  \centering
  \includegraphics[totalheight=0.2\textheight]{img/imnext_novo_usuario.png}
  \caption{Dados de novo usuário}
  \label{fig:dados_novo_usuario}
\end{figure}

Caso o endereço que você adicionou pôde ser encontrado, o \emph{IM
  Next} mostrará em sua barra inferior que você encontra-se
desconectado \ref{fig:usuario_desconectado}. Caso o endereço não possa
ser encontrado, a barra informará.

\begin{figure}
  \centering
    \includegraphics[totalheight=0.2\textheight]{img/imnext_usuario_desconectado.png}
  \caption{Usuário desconectado - versão Desktop}
  \label{fig:usuario_desconectado}
\end{figure}

Para conectar, clique em
\textit{Arquivo}$\rightarrow$\textit{Conectar}\ref{fig:conectar}. A
barra inferior informará caso a conexão tenha sido realizada com
sucesso.

\begin{figure}
  \centering
    \includegraphics[totalheight=0.2\textheight]{img/imnext_conectar.png}
  \caption{Conectar - versão Desktop}
  \label{fig:conectar}
\end{figure}

Após conectado, as pessoas próximas à você serão mostradas na tabela
\textit{Next}\ref{fig:conectado_gente_perto}. Para conversar com
alguém, clique no nome da pessoa a qual deseja direcionar sua
mensagem, digite a mensagem no campo ao lado do botão \textit{Enviar}
e clique no botão ou pressione \textit{enter}.

\begin{figure}
  \centering
    \includegraphics[totalheight=0.2\textheight]{img/imnext_conectado_gente_perto.png}
  \caption{Conectado com pessoas perto - versão Desktop}
  \label{fig:conectado_gente_perto}
\end{figure}

O \emph{IM Next} salva suas configuração automaticamente. Caso você
feche e abra o programa mais tarde seu nome de usuário, senha e local
serão carregados.

Por fim, você pode também alterar somente o local\footnote{O local
  pode ser especificado tanto quanto queira, incluindo nomes de ruas e
  números} onde você esteja clicando em
\textit{Configurações}$\rightarrow$\textit{Registra Posição}.

\subsection{Requisitos}

Os requisitos mínimos para a execução do \textbf{Cliente} são:

\begin{itemize}
\item python
\item pygtk
\item hildon
\item python-beautifulsoup
\item python-simplejson
\item python-xmpp
\item \href{http://exogen.case.edu/projects/geopy/}{geopy}
\end{itemize}


\section{Bot}

O \textbf{Bot} deve estar sempre rodando. É através deles que os
clientes sabem quem esta perto apesar desta função ser totalmente
transparente para eles.

\subsection{Instalação}

O \textbf{Bot} não deve ser instalado pois ele é uma peça central para
a execução da plataforma \emph{IM Next} e deve haver somente uma
instância rodando por vez.

\subsection{Execução}

Ele encontra-se no diretório \textit{src/bot/} da distribuição. Pode
ser executado a partir do Moblin mas é recomendado que seja executado
a partir de um Desktop, de preferência um poderoso, pois quanto mais
clientes estiverem rodando, maior será a carga exigida.

Para executa-lo, escreva no terminal:

\begin{verbatim}
./imn_bot.py nome_do_bot senha_do_bot
\end{verbatim}

Troque \textbf{nome\_do\_bot} e \textbf{senha\_do\_bot} por valores
apropriados.

\subsection{Requisitos}

Os requisitos mínimos para a execução do \textbf{Bot} são:

\begin{itemize}
\item python
\item python-xmpp
\end{itemize}


\end{document}







